home *** CD-ROM | disk | FTP | other *** search
/ IRIX Installation Tools & Overlays 2002 May / SGI IRIX Installation Tools & Overlays 2002 May - Disc 3.iso / relnotes / dynaweb / ch2.z / ch2
Text File  |  2002-04-11  |  11KB  |  263 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        2.  _I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  9.  
  10.        This chapter lists supplemental information to the _I_R_I_S
  11.        _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e.  The information listed here is
  12.        product- and release-specific; use it with the Installation
  13.        Guide to install this product.
  14.  
  15.        Dynaweb is a CGI program meant to be executed by an existing
  16.        HTTP server (such as the Netscape Fasttrack or Enterprise
  17.        server), allowing web-based viewing of online documentation
  18.        locally available via the IRIS InSight tool.
  19.  
  20.  
  21.        2.1  _D_y_n_a_w_e_b__S_u_b_s_y_s_t_e_m_s
  22.  
  23.        Dynaweb includes these subsystems:
  24.  
  25.        _d_y_n_a_w_e_b._m_a_n._m_a_n        Dynaweb (InSight to HTML) Man Pages, 4.4.1
  26.        _d_y_n_a_w_e_b._m_a_n._r_e_l_n_o_t_e_s   Dynaweb (InSight to HTML) Release Notes, 4.4.1
  27.        _d_y_n_a_w_e_b._s_w._e_o_e         Dynaweb (InSight to HTML) Software, 4.4.1
  28.  
  29.  
  30.  
  31.        2.2  _D_y_n_a_w_e_b__S_u_b_s_y_s_t_e_m__D_i_s_k__S_p_a_c_e__R_e_q_u_i_r_e_m_e_n_t_s
  32.  
  33.        This section lists the subsystems (and their sizes) of
  34.        Dynaweb.
  35.  
  36.        If you are installing this product for the first time, the
  37.        subsystems marked ``default'' are the ones that are
  38.        installed if you use the ``go'' menu item.  To install a
  39.        different set of subsystems, use the ``install,''
  40.        ``remove,'' ``keep,'' and ``step'' commands in _i_n_s_t to
  41.        customize the list of subsystems to be installed, then
  42.        select the ``go'' menu item.
  43.  
  44.        Note:  The listed subsystem sizes are approximate. Refer to
  45.               the _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for information
  46.               on finding exact sizes.
  47.  
  48.  
  49.  
  50.        Subsystem Name                   Subsystem Size (Kilobytes)
  51.  
  52.        _d_y_n_a_w_e_b._m_a_n._m_a_n (default)        1
  53.        _d_y_n_a_w_e_b._m_a_n._r_e_l_n_o_t_e_s (default)   12
  54.        _d_y_n_a_w_e_b._s_w._e_o_e (default)         7561
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                                   - 2 -
  69.  
  70.  
  71.  
  72.  
  73.  
  74.        2.3  _I_n_s_t_a_l_l_a_t_i_o_n__M_e_t_h_o_d
  75.  
  76.        All of the subsystems for Dynaweb can be installed using
  77.        IRIX.  You do not need to use the miniroot. Refer to the
  78.        _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for complete installation
  79.        instructions.
  80.  
  81.        2.4  _P_r_e_r_e_q_u_i_s_i_t_e_s
  82.  
  83.        Dynaweb requires that the latest _i_n_s_i_g_h_t__b_a_s_e._s_w._e_o_e be
  84.        installed.  You should also have some IRIS InSight books
  85.        installed.
  86.  
  87.        2.5  _C_o_n_f_i_g_u_r_a_t_i_o_n__F_i_l_e_s
  88.  
  89.        Additional InSight bookshelves can be added to Dynaweb
  90.        through modifications made to
  91.        /_u_s_r/_l_i_b/_I_n_s_i_g_h_t/_d_a_t_a/_c_o_n_f_i_g/_c_o_l_l_e_c_t_s._d_w_c. See comments
  92.        within that file for more information.
  93.  
  94.  
  95.        2.6  _O_t_h_e_r__I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  96.  
  97.  
  98.        The Dynaweb installation links your existing IRIS InSight
  99.        library location into your HTTP server's document root. By
  100.        default, the command is as follows:
  101.  
  102.           #### llllnnnn ----ssss ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy ////vvvvaaaarrrr////wwwwwwwwwwww////hhhhttttddddooooccccssss
  103.  
  104.        This is necessary for Dynaweb to run properly. If your IRIS
  105.        InSight library location _O_R your HTTP server's document root
  106.        differ from the defaults shown above, please execute this
  107.        command (via a shell) with the correct values.
  108.  
  109.  
  110.        Dynaweb runs as a CGI (Common Gateway Interface) process.
  111.        Most HTTP servers from SGI ship configured for Dynaweb to
  112.        run properly.  For example, Dynaweb will work with any
  113.        server instance of Fasttrack (2.01, 3.02, etc.) or
  114.        Enterprise (2.01, 3.0, etc.) that has been correctly
  115.        configured.
  116.  
  117.        If you have an existing server instance already installed
  118.        (or are having problems running Dynaweb) this server
  119.        instance may not be properly configured for Dynaweb to work.
  120.        Follow these steps:
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.                                   - 3 -
  135.  
  136.  
  137.  
  138.           +o Edit the obj.conf file for the server instance you will
  139.             be using.  For example, on a default Fasttrack 2.01
  140.             installation, the obj.conf file would be found at
  141.             (replace [hostname] with the host name of the system):
  142.  
  143.  
  144.                ////uuuussssrrrr////nnnnssss----hhhhoooommmmeeee////hhhhttttttttppppdddd----[[[[hhhhoooossssttttnnnnaaaammmmeeee]]]]////ccccoooonnnnffffiiiigggg////oooobbbbjjjj....ccccoooonnnnffff
  145.  
  146.             On a default Fasttrack 3.x installation, the obj.conf
  147.             file would be found at (replace [hostname] with the
  148.             host name of the system):
  149.  
  150.  
  151.                ////vvvvaaaarrrr////nnnneeeettttssssccccaaaappppeeee////ffffaaaassssttttttttrrrraaaacccckkkk////hhhhttttttttppppdddd----[[[[hhhhoooossssttttnnnnaaaammmmeeee]]]]////ccccoooonnnnffffiiiigggg////oooobbbbjjjj....ccccoooonnnnffff
  152.  
  153.             On a default Enterprise 3.0 installation, the obj.conf
  154.             file would be found at (replace [hostname] with the
  155.             host name of the system):
  156.  
  157.  
  158.                ////vvvvaaaarrrr////nnnneeeettttssssccccaaaappppeeee////ssssuuuuiiiitttteeeessssppppooootttt////hhhhttttttttppppssss----[[[[hhhhoooossssttttnnnnaaaammmmeeee]]]]////ccccoooonnnnffffiiiigggg////oooobbbbjjjj....ccccoooonnnnffff
  159.  
  160.           +o Locate the following line in obj.conf (exact syntax may
  161.             vary, but it is the definition of the primary /cgi-bin
  162.             directory):
  163.  
  164.  
  165.                NNNNaaaammmmeeeeTTTTrrrraaaannnnssss ffffnnnn====""""ppppffffxxxx2222ddddiiiirrrr"""" ffffrrrroooommmm====""""////ccccggggiiii----bbbbiiiinnnn"""" ddddiiiirrrr====""""////vvvvaaaarrrr////wwwwwwwwwwww////ccccggggiiii----bbbbiiiinnnn"""" nnnnaaaammmmeeee====""""ccccggggiiii""""
  166.  
  167.           +o Immediately after this line, add the following two
  168.             lines:
  169.  
  170.  
  171.                NNNNaaaammmmeeeeTTTTrrrraaaannnnssss ffffnnnn====""""ppppffffxxxx2222ddddiiiirrrr"""" ffffrrrroooommmm====""""////eeeebbbbtttt----bbbbiiiinnnn"""" ddddiiiirrrr====""""////uuuussssrrrr////lllliiiibbbb////IIIInnnnssssiiiigggghhhhtttt////ddddwwwweeeebbbb////ccccggggiiii----bbbbiiiinnnn"""" nnnnaaaammmmeeee====""""ccccggggiiii""""
  172.                NNNNaaaammmmeeeeTTTTrrrraaaannnnssss ffffnnnn====""""ppppffffxxxx2222ddddiiiirrrr"""" ffffrrrroooommmm====""""////eeeebbbbtttt----iiiiccccoooonnnnssss"""" ddddiiiirrrr====""""////uuuussssrrrr////lllliiiibbbb////IIIInnnnssssiiiigggghhhhtttt////ddddwwwweeeebbbb////iiiiccccoooonnnnssss""""
  173.  
  174.             Ideally, you should use the Netscape Admin Server to
  175.             perform this operation for you. However, the lines can
  176.             be added by hand.
  177.  
  178.           +o After adding the appropriate information, the HTTP
  179.             server will need to be restarted.
  180.  
  181.        Alternatively, if you are running a NCSA-style server, place
  182.        the following lines in the file
  183.        <server_config_dir>/srm.conf:
  184.  
  185.  
  186.           AAAAlllliiiiaaaassss  ////eeeebbbbtttt----iiiiccccoooonnnnssss//// ////uuuussssrrrr////lllliiiibbbb////IIIInnnnssssiiiigggghhhhtttt////ddddwwwweeeebbbb////iiiiccccoooonnnnssss////
  187.           SSSSccccrrrriiiippppttttAAAAlllliiiiaaaassss ////eeeebbbbtttt----bbbbiiiinnnn////nnnnpppphhhh----ddddwwwweeeebbbb ////uuuussssrrrr////lllliiiibbbb////IIIInnnnssssiiiigggghhhhtttt////ddddwwwweeeebbbb////ccccggggiiii----bbbbiiiinnnn////nnnnpppphhhh----ddddwwwweeeebbbb
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.                                   - 4 -
  201.  
  202.  
  203.  
  204.        2.7  _E_x_e_c_u_t_i_o_n__A_f_t_e_r__I_n_s_t_a_l_l_a_t_i_o_n
  205.  
  206.        After the software has been installed, you can examine the
  207.        contents of your IRIS InSight library under Dynaweb:
  208.  
  209.           %%%% <<<<wwwweeeebbbb____bbbbrrrroooowwwwsssseeeerrrr>>>> hhhhttttttttpppp::::////////llllooooccccaaaallllhhhhoooosssstttt////eeeebbbbtttt----bbbbiiiinnnn////nnnnpppphhhh----ddddwwwweeeebbbb////ddddyyyynnnnaaaawwwweeeebbbb
  210.  
  211.        Substitute your favorite WWW browser for "<web_browser>" in
  212.        the previous example.
  213.  
  214.        If "localhost" does not work as shown above, substitute the
  215.        appropriate HTTP server name/port for the machine in which
  216.        Dynaweb has been installed.
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.